Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Print Object Messages

GXDefaultDesktopPrinter

QuickDraw GX sends the GXDefaultDesktopPrinter message when the user creates a new desktop printer with the Chooser. You can override the GXDefaultDesktopPrinter message to modify the configuration file of the desktop printer. Your override of the GXDefaultDesktopPrinter message must match the following formal declaration:

OSErr MyDefaultDesktopPrinter (Str31 dtpName);

dtpName

The name of the desktop printer.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXDefaultDesktopPrinter message when a user creates
a new desktop printer.

You override this message if you need to add additional data to the printer's configuration file. For example, you may want your driver to supply an application with the list of the valid color spaces and printing devices that it supports or you might want to fill in the default configuration for the printer. After you forward this message down the message chain, you can add your own information to the printer object or change information that was placed there by the default implementation. The default implementation of this message fills in the default information for the printer object.

SPECIAL CONSIDERATIONS

You never send the GXDefaultDesktopPrinter message yourself.

You must forward the GXDefaultDesktopPrinter message to other message handlers. Always forward it before you add or change configuration information.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

Creating desktop printers is described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help